home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / cocogif.z / cocogif
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCOOOOCCCCOOOOGGGGIIIIFFFF((((1111))))                           CCCCMMMMSSSS                            CCCCOOOOCCCCOOOOGGGGIIIIFFFF((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cocogif - color correct a GIF image file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_oooo_cccc_oooo_gggg_iiii_ffff [ _----_aaaa _s_o_u_r_c_e__p_r_o_f_i_l_e | _----_ssss _s_o_u_r_c_e__p_r_o_f_i_l_e ] _----_dddd _d_e_s_t_i_n_a_t_i_o_n__p_r_o_f_i_l_e
  13.                [ _----_hhhh ] [ _----_oooo _o_u_t_p_u_t__f_i_l_e ] [ _i_n_p_u_t__f_i_l_e ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _c_o_c_o_g_i_f uses the International Color Consortium (ICC) profiles to
  17.      determine how to perform the appropriate color management operation
  18.      ("color correction", hence "coco") upon a GIF image file. The operation
  19.      will be a color space conversion from the input device color space to the
  20.      output device color space.
  21.  
  22.      The device color space associated with the input stream is determined in
  23.      one of four ways. The following approaches are tried in order:
  24.  
  25.      +o    First, if the _----_ssss flag is set, the specified _s_o_u_r_c_e-_p_r_o_f_i_l_e will be
  26.           used.  Specifying _----_ssss will override any profile embedded in the
  27.           source image.
  28.  
  29.      +o    Second, if there is an ICC profile embedded in the source image,
  30.           that will be used.
  31.  
  32.      +o    Third, if the _----_aaaa flag is set, the specified _s_o_u_r_c_e__p_r_o_f_i_l_e will be
  33.           used.  Embedded profiles take precedence over profiles specified
  34.           with _----_aaaa.
  35.  
  36.      +o    Finally, the color management system's default RGB profile will be
  37.           used.  If no default is set, the system searches through
  38.           _CCCC_MMMM_SSSS______PPPP_RRRR_OOOO_FFFF_IIII_LLLL_EEEE______PPPP_AAAA_TTTT_HHHH for the default monitor profile, _mmmm_oooo_nnnn_iiii_tttt_oooo_rrrr_...._pppp_ffff.  If
  39.           that profile is not found, _cccc_oooo_cccc_oooo_gggg_iiii_ffff has no way to determine a source
  40.           device profile and so passes the input image stream through
  41.           unchanged.
  42.  
  43.      The output device color space is determined quite simply from the value
  44.      of the _----_dddd flag.
  45.  
  46.      If a full path is not provided for a device profile, the system looks
  47.      through the directories specified in _CCCC_MMMM_SSSS______PPPP_RRRR_OOOO_FFFF_IIII_LLLL_EEEE______PPPP_AAAA_TTTT_HHHH.
  48.  
  49.      If, for any reason _cccc_oooo_cccc_oooo_gggg_iiii_ffff is unable to perform the requested conversion,
  50.      the source stream is copied to the destination stream.  Some of the
  51.      reasons that a conversion might not be performed are:
  52.  
  53.      +o    no destination profile was specified;
  54.  
  55.      +o    the number of channels in the input or output stream does not match
  56.           its profile;
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCOOOOCCCCOOOOGGGGIIIIFFFF((((1111))))                           CCCCMMMMSSSS                            CCCCOOOOCCCCOOOOGGGGIIIIFFFF((((1111))))
  71.  
  72.  
  73.  
  74.      +o    one of the specified profiles could not be found;
  75.  
  76.      +o    one of the specified profiles could not be read;
  77.  
  78.      +o    the source image is one bit deep;
  79.  
  80.      +o    the CMS did not know how to handle one of the profiles;
  81.  
  82.      +o    the CMS needed to read the system RGB profile and could not.
  83.  
  84. CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  85.      _c_o_c_o_g_i_f supports the following command line options:
  86.  
  87.      _----_aaaa _s_o_u_r_c_e__p_r_o_f_i_l_e
  88.                Specifies a profile to be used with images that do not have an
  89.                embedded ICC profile.
  90.  
  91.      _----_dddd _d_e_s_t_i_n_a_t_i_o_n__p_r_o_f_i_l_e
  92.                Specifies a profile for the destination device. The destination
  93.                image file format, including the depth and number of channels,
  94.                will be determined by this profile.
  95.  
  96.      _----_hhhh        Display a usage message.
  97.  
  98.      _----_oooo _o_u_t_p_u_t__f_i_l_e
  99.                The output GIF file. If this is not supplied, _cccc_oooo_cccc_oooo_gggg_iiii_ffff will
  100.                write to standard out.
  101.  
  102.      _----_ssss _s_o_u_r_c_e__p_r_o_f_i_l_e
  103.                The profile for the source device.  This will override any
  104.                profile embedded in the image.  If this profile does not match
  105.                up with the source stream/source file image file format,
  106.                _cccc_oooo_cccc_oooo_gggg_iiii_ffff will pass the source through unchanged.
  107.  
  108.      _i_n_p_u_t__f_i_l_e
  109.                The input GIF file.  If this is not supplied, _cccc_oooo_cccc_oooo_gggg_iiii_ffff will read
  110.                from standard in.
  111.  
  112.  
  113. EEEERRRRRRRROOOORRRRSSSS
  114.      Because _cccc_oooo_cccc_oooo_gggg_iiii_ffff is a filter, it tries to produce valid output if at all
  115.      possible.  However, there are conditions under which _cccc_oooo_cccc_oooo_gggg_iiii_ffff will exit
  116.      with an error condition. These are:
  117.  
  118.      +o    a source file was specified, but could not be opened;
  119.  
  120.      +o    a destination file was specified, but could not be opened;
  121.  
  122.      +o    an unrecoverable system error.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.